home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / pcr / pcr4_4.lha / DIST / debugnub / INCLUDE / xr / CirioNubLocalProcs.h < prev    next >
C/C++ Source or Header  |  1990-11-05  |  5KB  |  232 lines
  1. /* begincopyright
  2.   Copyright (c) 1988 Xerox Corporation. All rights reserved.
  3.   Use and copying of this software and preparation of derivative works based
  4.   upon this software are permitted. Any distribution of this software or
  5.   derivative works must comply with all applicable United States export
  6.   control laws. This software is made available AS IS, and Xerox Corporation
  7.   makes no warranty about the software, its performance or its conformity to
  8.   any specification. Any person obtaining a copy of this software is requested
  9.   to send their name and post office or electronic mail address to:
  10.     PCR Coordinator
  11.     Xerox PARC
  12.     3333 Coyote Hill Rd.
  13.     Palo Alto, CA 94304
  14.   endcopyright */
  15.  
  16. /*
  17.  * CirioNubLocalProcs.h
  18.  *
  19.  * Demers, November 5, 1990 8:49:02 am PST
  20.  *
  21.  * CirioNub local procedure descriptions.
  22.  */
  23.  
  24. #ifndef _CIRIO_NUB_LOCAL_PROCS_
  25. #define _CIRIO_NUB_LOCAL_PROCS_
  26.  
  27. #ifndef _CIRIO_NUB_TYPES_
  28. #   include "xr/CirioNubTypes.h"
  29. #endif
  30.  
  31.  
  32. #define CIRIO_NUB_LOCAL_PROCS_LOW_VERSION    1
  33. #define CIRIO_NUB_LOCAL_PROCS_VERSION        2
  34.  
  35.  
  36. extern bool
  37. CirioNubLocalGetIgnoreLockFailure();
  38.  
  39. extern void
  40. CirioNubLocalSetIgnoreLockFailure(/* bool ignore */);
  41. /*
  42.     TRUE => local procs ignore failure to acquire load state lock and
  43.       forge ahead anyway.
  44. */
  45.  
  46.  
  47.  
  48. extern unsigned
  49. CirioNubLocalNull(/* unsigned desiredVersion */);
  50. /*
  51.     Return the "best" Cirio nub version number exported by this nub.
  52. */
  53.  
  54.  
  55. extern int
  56. CirioNubLocalGetThread(/* int index, CirioNubThreadData buf */);
  57. /*
  58.     Get data about specified thread.
  59.     Return 0 on success, (-1) on failure (specified thread inactive).
  60. */
  61.  
  62.  
  63. extern int
  64. CirioNubLocalPCtoInfo(/* XR_Pointer pc, CirioNubPCInfo buf */);
  65. /*
  66.     Map absolute pc to info.
  67.     Return 0 on success, (-1) on failure.
  68. */
  69.  
  70. /*
  71.  * For the following procs, consult IncrementalLoad.h
  72.  */
  73.  
  74.  
  75. extern int
  76. CirioNubLocalGetFileEntry(/* unsigned seqNum, CirioNubFileEntry buf */);
  77. /*
  78.     Get file entry with largest seqNum <= the specified one.
  79.     Return 0 on success, -1 on failure.
  80. */
  81.  
  82.  
  83. extern int
  84. CirioNubLocalGetMatchingSymEntryByName(/*
  85.     unsigned symID,
  86.     char *pattern,
  87.     bool caseSensitive,
  88.     unsigned wantedTypes,
  89.     unsigned ignoredClasses,
  90.     int numToSkip,
  91.     CirioNubSymEntry buf
  92. */);
  93. /*
  94.     Like XR_ILGetMatchingSymEntryByName.
  95.     Returns 0 on success, (-1) on error.
  96. */
  97.  
  98. extern int
  99. CirioNubLocalGetMatchingSymEntryByValue(/*
  100.     unsigned symID,
  101.     unsigned val,
  102.     unsigned wantedTypes,
  103.     unsigned ignoredClasses,
  104.     int numToSkip,
  105.     CirioNubSymEntry buf
  106. */);
  107. /*
  108.     Like XR_ILGetMatchingSymEntryByValue.
  109.     Returns 0 on success, (-1) on error.
  110. */
  111.  
  112.  
  113.  
  114.  
  115. /*
  116.  * Replace a patch area ... OBSOLETE
  117.  */
  118.  
  119. extern int
  120. CirioNubLocalReplacePatchArea(/*
  121.     XR_Pointer pc,
  122.     XR_Pointer newPatchArea,
  123.     unsigned long newSize
  124. */);
  125. /*
  126.     Replace the patch area associated with given pc value.
  127.     If newPatchArea is NIL, CirioNubLocalReplacePatchArea will allocate
  128.       a new patch area of the requested size.
  129.     Return 0 on success, (-1) on failure.
  130. */
  131.  
  132.  
  133. /*
  134.  * Remote debugging listener query
  135.  */
  136.  
  137. extern int
  138. CirioNubLocalGetPort();
  139. /*
  140.     Return port at which local debugnub is listening.
  141.     Return 0 if no local debugnub is running.
  142.     Return (-1) on other failure.
  143. */
  144.  
  145.  
  146. /*
  147.     OBSOLETE:
  148. */
  149. extern int
  150. CirioNubLocalLookupSymEntryByName(/*
  151.     char *sym,
  152.     bool caseSensitive,
  153.     bool externOnly,
  154.     int numToSkip,
  155.     CirioNubSymEntry buf
  156. */);
  157. /*
  158.     Lookup symbol by name,
  159.       then skip backward the specified number of symbols.
  160.     Return 0 on success, (-1) on error.
  161. */
  162.  
  163.  
  164. extern int
  165. CirioNubLocalLookupSymEntryByValue(/*
  166.     unsigned val,
  167.     int numToSkip,
  168.     CirioNubSymEntry buf
  169. */);
  170. /*
  171.     Lookup symbol entry by value -- get most-recently-loaded symbol
  172.       of highest value <= val.
  173.     Then skip forward (numToSkip > 0) or backward (numToSkip < 0).
  174.     Return 0 on success, (-1) on failure.
  175. */
  176.  
  177. extern int
  178. CirioNubLocalLookupSymEntryByID(/*
  179.     unsigned symID,
  180.     CirioNubSymEntry buf
  181. */);
  182. /*
  183.     Lookup symbol entry by ID.
  184.     This is included for completeness; it is equivalent to
  185.  
  186.         CirioNubLocalSkipSymEntryByValue(symID, 0, buf)
  187.  
  188.     See below.
  189. */
  190.  
  191. extern int
  192. CirioNubLocalSkipSymEntryByName(/*
  193.     unsigned symID,
  194.     bool caseSensitive,
  195.     bool externOnly,
  196.     int numToSkip,
  197.     CirioNubSymEntry buf
  198. */);
  199. /*
  200.     Skip forward/backward specified number of symbols by name.
  201.     Return 0 on success, (-1) on failure.
  202. */
  203.  
  204. extern int
  205. CirioNubLocalSkipSymEntryByValue(/*
  206.     unsigned symID,
  207.     int numToSkip,
  208.     CirioNubSymEntry buf
  209. */);
  210. /*
  211.     Skip forward/backward specified number of symbols by value.
  212.     Return 0 on success, (-1) on failure.
  213. */
  214.  
  215.  
  216. extern int
  217. CirioNubLocalGetMaxThreads();
  218. /*
  219.     Return max number of threads supported.
  220. */
  221.  
  222. extern int
  223. CirioNubLocalGetThreadIndex(/* XR_CT t */);
  224. /*
  225.     Return thread index of thread t.
  226.     If t == NIL interpret as current thread.
  227.     Return (-1) on error (t invalid).
  228. */
  229.  
  230. #endif /* _CIRIO_NUB_LOCAL_PROCS_ */
  231.  
  232.